<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>texture_laws [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_filters.html">过滤器</a> / <a href="toc_filters_texture.html">Texture Inspection</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">texture_laws</span><span data-if="c" style="display:none;">texture_laws</span><span data-if="cpp" style="display:none;">TextureLaws</span><span data-if="dotnet" style="display:none;">TextureLaws</span><span data-if="python" style="display:none;">texture_laws</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">texture_laws</span><span data-if="c" style="display:none;">texture_laws</span><span data-if="cpp" style="display:none;">TextureLaws</span><span data-if="dotnet" style="display:none;">TextureLaws</span><span data-if="python" style="display:none;">texture_laws</span></code> — Filter an image using a Laws texture filter.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>texture_laws</b>(<a href="#Image"><i>Image</i></a> : <a href="#ImageTexture"><i>ImageTexture</i></a> : <a href="#FilterTypes"><i>FilterTypes</i></a>, <a href="#Shift"><i>Shift</i></a>, <a href="#FilterSize"><i>FilterSize</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>texture_laws</b>(const Hobject <a href="#Image"><i>Image</i></a>, Hobject* <a href="#ImageTexture"><i>ImageTexture</i></a>, const char* <a href="#FilterTypes"><i>FilterTypes</i></a>, const Hlong <a href="#Shift"><i>Shift</i></a>, const Hlong <a href="#FilterSize"><i>FilterSize</i></a>)</code></p>
<p>
<code>Herror <b>T_texture_laws</b>(const Hobject <a href="#Image"><i>Image</i></a>, Hobject* <a href="#ImageTexture"><i>ImageTexture</i></a>, const Htuple <a href="#FilterTypes"><i>FilterTypes</i></a>, const Htuple <a href="#Shift"><i>Shift</i></a>, const Htuple <a href="#FilterSize"><i>FilterSize</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>TextureLaws</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, HObject* <a href="#ImageTexture"><i>ImageTexture</i></a>, const HTuple&amp; <a href="#FilterTypes"><i>FilterTypes</i></a>, const HTuple&amp; <a href="#Shift"><i>Shift</i></a>, const HTuple&amp; <a href="#FilterSize"><i>FilterSize</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>TextureLaws</b>(const HString&amp; <a href="#FilterTypes"><i>FilterTypes</i></a>, Hlong <a href="#Shift"><i>Shift</i></a>, Hlong <a href="#FilterSize"><i>FilterSize</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>TextureLaws</b>(const char* <a href="#FilterTypes"><i>FilterTypes</i></a>, Hlong <a href="#Shift"><i>Shift</i></a>, Hlong <a href="#FilterSize"><i>FilterSize</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>TextureLaws</b>(const wchar_t* <a href="#FilterTypes"><i>FilterTypes</i></a>, Hlong <a href="#Shift"><i>Shift</i></a>, Hlong <a href="#FilterSize"><i>FilterSize</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>TextureLaws</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, out <a href="HObject.html">HObject</a> <a href="#ImageTexture"><i>imageTexture</i></a>, <a href="HTuple.html">HTuple</a> <a href="#FilterTypes"><i>filterTypes</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Shift"><i>shift</i></a>, <a href="HTuple.html">HTuple</a> <a href="#FilterSize"><i>filterSize</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>TextureLaws</b>(string <a href="#FilterTypes"><i>filterTypes</i></a>, int <a href="#Shift"><i>shift</i></a>, int <a href="#FilterSize"><i>filterSize</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>texture_laws</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#FilterTypes"><i>filter_types</i></a>: str, <a href="#Shift"><i>shift</i></a>: int, <a href="#FilterSize"><i>filter_size</i></a>: int) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">texture_laws</span><span data-if="c" style="display:none">texture_laws</span><span data-if="cpp" style="display:none">TextureLaws</span><span data-if="com" style="display:none">TextureLaws</span><span data-if="dotnet" style="display:none">TextureLaws</span><span data-if="python" style="display:none">texture_laws</span></code> applies a texture transformation (according to
Laws) to an image.  This is done by convolving the input image with
a special filter mask.  The filters are:
</p>
<p>9 different 3×3 matrices obtainable from the following three
vectors:
<span class="pre">
    l      =       [  1     2       1  ],
    e      =       [ -1     0       1  ],
    s      =       [ -1     2      -1  ]
</span>
25 different 5×5 matrices obtainable from the following five
vectors:
<span class="pre">
    l      =       [  1     4       6       4       1 ],
    e      =       [ -1    -2       0       2       1 ],
    s      =       [ -1     0       2       0      -1 ],
    w      =       [ -1     2       0      -2       1 ]
    r      =       [  1    -4       6      -4       1 ],
</span>
49 different 7×7 matrices obtainable from the following seven
vectors:
<span class="pre">
    l      =       [  1     6      15      20      15      6      1  ],
    e      =       [ -1    -4      -5       0       5      4      1  ],
    s      =       [ -1    -2       1       4       1     -2     -1  ],
    w      =       [ -1     0       3       0      -3      0      1  ],
    r      =       [  1    -2      -1       4      -1     -2      1  ],
    u      =       [  1    -4       5       0      -5      4     -1  ]
    o      =       [ -1     6     -15      20     -15      6     -1  ]
</span>
The names of the filters are mnemonics for “level,” “edge,”
“spot,” “wave,” “ripple,” “undulation,” and “oscillation.”
</p>
<p>For most of the filters the resulting gray values must be modified
by a <a href="#Shift"><i><code><span data-if="hdevelop" style="display:inline">Shift</span><span data-if="c" style="display:none">Shift</span><span data-if="cpp" style="display:none">Shift</span><span data-if="com" style="display:none">Shift</span><span data-if="dotnet" style="display:none">shift</span><span data-if="python" style="display:none">shift</span></code></i></a>.  This makes the different textures in the
output image more comparable to each other, provided suitable
filters are used.
</p>
<p>The name of the filter is composed of the letters of the two vectors
used, where the first letter denotes convolution in the column
direction while the second letter denotes convolution in the row
direction.</p>
<h2 id="sec_attention">注意</h2>
<p><code><span data-if="hdevelop" style="display:inline">texture_laws</span><span data-if="c" style="display:none">texture_laws</span><span data-if="cpp" style="display:none">TextureLaws</span><span data-if="com" style="display:none">TextureLaws</span><span data-if="dotnet" style="display:none">TextureLaws</span><span data-if="python" style="display:none">texture_laws</span></code> can be executed on OpenCL devices.
</p>
<p>Note that filter operators may return unexpected results if
an image with a reduced domain is used as input. Please refer to the
chapter <a href="toc_filters.html">过滤器</a>.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
    
      <li>支持OpenCL计算设备。</li>
    
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
    <li>在图像通道级别自动并行化。</li>
    <li>Automatically parallelized on  domain level.</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte* / int2* / uint2*)<i> *allowed for compute devices</i></span>
</div>
<p class="pardesc">Images to which the texture transformation is to be
applied.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageTexture" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageTexture</span><span data-if="c" style="display:none">ImageTexture</span><span data-if="cpp" style="display:none">ImageTexture</span><span data-if="com" style="display:none">ImageTexture</span><span data-if="dotnet" style="display:none">imageTexture</span><span data-if="python" style="display:none">image_texture</span></code></b> (output_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (byte / int2 / uint2)</span>
</div>
<p class="pardesc">Texture images.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="FilterTypes" class="parname"><b><code><span data-if="hdevelop" style="display:inline">FilterTypes</span><span data-if="c" style="display:none">FilterTypes</span><span data-if="cpp" style="display:none">FilterTypes</span><span data-if="com" style="display:none">FilterTypes</span><span data-if="dotnet" style="display:none">filterTypes</span><span data-if="python" style="display:none">filter_types</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Desired filter.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'el'</span>
    <span data-if="c" style="display:none">"el"</span>
    <span data-if="cpp" style="display:none">"el"</span>
    <span data-if="com" style="display:none">"el"</span>
    <span data-if="dotnet" style="display:none">"el"</span>
    <span data-if="python" style="display:none">"el"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'ll'</span><span data-if="c" style="display:none">"ll"</span><span data-if="cpp" style="display:none">"ll"</span><span data-if="com" style="display:none">"ll"</span><span data-if="dotnet" style="display:none">"ll"</span><span data-if="python" style="display:none">"ll"</span>, <span data-if="hdevelop" style="display:inline">'le'</span><span data-if="c" style="display:none">"le"</span><span data-if="cpp" style="display:none">"le"</span><span data-if="com" style="display:none">"le"</span><span data-if="dotnet" style="display:none">"le"</span><span data-if="python" style="display:none">"le"</span>, <span data-if="hdevelop" style="display:inline">'ls'</span><span data-if="c" style="display:none">"ls"</span><span data-if="cpp" style="display:none">"ls"</span><span data-if="com" style="display:none">"ls"</span><span data-if="dotnet" style="display:none">"ls"</span><span data-if="python" style="display:none">"ls"</span>, <span data-if="hdevelop" style="display:inline">'lw'</span><span data-if="c" style="display:none">"lw"</span><span data-if="cpp" style="display:none">"lw"</span><span data-if="com" style="display:none">"lw"</span><span data-if="dotnet" style="display:none">"lw"</span><span data-if="python" style="display:none">"lw"</span>, <span data-if="hdevelop" style="display:inline">'lr'</span><span data-if="c" style="display:none">"lr"</span><span data-if="cpp" style="display:none">"lr"</span><span data-if="com" style="display:none">"lr"</span><span data-if="dotnet" style="display:none">"lr"</span><span data-if="python" style="display:none">"lr"</span>, <span data-if="hdevelop" style="display:inline">'lu'</span><span data-if="c" style="display:none">"lu"</span><span data-if="cpp" style="display:none">"lu"</span><span data-if="com" style="display:none">"lu"</span><span data-if="dotnet" style="display:none">"lu"</span><span data-if="python" style="display:none">"lu"</span>, <span data-if="hdevelop" style="display:inline">'lo'</span><span data-if="c" style="display:none">"lo"</span><span data-if="cpp" style="display:none">"lo"</span><span data-if="com" style="display:none">"lo"</span><span data-if="dotnet" style="display:none">"lo"</span><span data-if="python" style="display:none">"lo"</span>, <span data-if="hdevelop" style="display:inline">'el'</span><span data-if="c" style="display:none">"el"</span><span data-if="cpp" style="display:none">"el"</span><span data-if="com" style="display:none">"el"</span><span data-if="dotnet" style="display:none">"el"</span><span data-if="python" style="display:none">"el"</span>, <span data-if="hdevelop" style="display:inline">'ee'</span><span data-if="c" style="display:none">"ee"</span><span data-if="cpp" style="display:none">"ee"</span><span data-if="com" style="display:none">"ee"</span><span data-if="dotnet" style="display:none">"ee"</span><span data-if="python" style="display:none">"ee"</span>, <span data-if="hdevelop" style="display:inline">'es'</span><span data-if="c" style="display:none">"es"</span><span data-if="cpp" style="display:none">"es"</span><span data-if="com" style="display:none">"es"</span><span data-if="dotnet" style="display:none">"es"</span><span data-if="python" style="display:none">"es"</span>, <span data-if="hdevelop" style="display:inline">'ew'</span><span data-if="c" style="display:none">"ew"</span><span data-if="cpp" style="display:none">"ew"</span><span data-if="com" style="display:none">"ew"</span><span data-if="dotnet" style="display:none">"ew"</span><span data-if="python" style="display:none">"ew"</span>, <span data-if="hdevelop" style="display:inline">'er'</span><span data-if="c" style="display:none">"er"</span><span data-if="cpp" style="display:none">"er"</span><span data-if="com" style="display:none">"er"</span><span data-if="dotnet" style="display:none">"er"</span><span data-if="python" style="display:none">"er"</span>, <span data-if="hdevelop" style="display:inline">'eu'</span><span data-if="c" style="display:none">"eu"</span><span data-if="cpp" style="display:none">"eu"</span><span data-if="com" style="display:none">"eu"</span><span data-if="dotnet" style="display:none">"eu"</span><span data-if="python" style="display:none">"eu"</span>, <span data-if="hdevelop" style="display:inline">'eo'</span><span data-if="c" style="display:none">"eo"</span><span data-if="cpp" style="display:none">"eo"</span><span data-if="com" style="display:none">"eo"</span><span data-if="dotnet" style="display:none">"eo"</span><span data-if="python" style="display:none">"eo"</span>, <span data-if="hdevelop" style="display:inline">'sl'</span><span data-if="c" style="display:none">"sl"</span><span data-if="cpp" style="display:none">"sl"</span><span data-if="com" style="display:none">"sl"</span><span data-if="dotnet" style="display:none">"sl"</span><span data-if="python" style="display:none">"sl"</span>, <span data-if="hdevelop" style="display:inline">'se'</span><span data-if="c" style="display:none">"se"</span><span data-if="cpp" style="display:none">"se"</span><span data-if="com" style="display:none">"se"</span><span data-if="dotnet" style="display:none">"se"</span><span data-if="python" style="display:none">"se"</span>, <span data-if="hdevelop" style="display:inline">'ss'</span><span data-if="c" style="display:none">"ss"</span><span data-if="cpp" style="display:none">"ss"</span><span data-if="com" style="display:none">"ss"</span><span data-if="dotnet" style="display:none">"ss"</span><span data-if="python" style="display:none">"ss"</span>, <span data-if="hdevelop" style="display:inline">'sw'</span><span data-if="c" style="display:none">"sw"</span><span data-if="cpp" style="display:none">"sw"</span><span data-if="com" style="display:none">"sw"</span><span data-if="dotnet" style="display:none">"sw"</span><span data-if="python" style="display:none">"sw"</span>, <span data-if="hdevelop" style="display:inline">'sr'</span><span data-if="c" style="display:none">"sr"</span><span data-if="cpp" style="display:none">"sr"</span><span data-if="com" style="display:none">"sr"</span><span data-if="dotnet" style="display:none">"sr"</span><span data-if="python" style="display:none">"sr"</span>, <span data-if="hdevelop" style="display:inline">'su'</span><span data-if="c" style="display:none">"su"</span><span data-if="cpp" style="display:none">"su"</span><span data-if="com" style="display:none">"su"</span><span data-if="dotnet" style="display:none">"su"</span><span data-if="python" style="display:none">"su"</span>, <span data-if="hdevelop" style="display:inline">'so'</span><span data-if="c" style="display:none">"so"</span><span data-if="cpp" style="display:none">"so"</span><span data-if="com" style="display:none">"so"</span><span data-if="dotnet" style="display:none">"so"</span><span data-if="python" style="display:none">"so"</span>, <span data-if="hdevelop" style="display:inline">'wl'</span><span data-if="c" style="display:none">"wl"</span><span data-if="cpp" style="display:none">"wl"</span><span data-if="com" style="display:none">"wl"</span><span data-if="dotnet" style="display:none">"wl"</span><span data-if="python" style="display:none">"wl"</span>, <span data-if="hdevelop" style="display:inline">'we'</span><span data-if="c" style="display:none">"we"</span><span data-if="cpp" style="display:none">"we"</span><span data-if="com" style="display:none">"we"</span><span data-if="dotnet" style="display:none">"we"</span><span data-if="python" style="display:none">"we"</span>, <span data-if="hdevelop" style="display:inline">'ws'</span><span data-if="c" style="display:none">"ws"</span><span data-if="cpp" style="display:none">"ws"</span><span data-if="com" style="display:none">"ws"</span><span data-if="dotnet" style="display:none">"ws"</span><span data-if="python" style="display:none">"ws"</span>, <span data-if="hdevelop" style="display:inline">'ww'</span><span data-if="c" style="display:none">"ww"</span><span data-if="cpp" style="display:none">"ww"</span><span data-if="com" style="display:none">"ww"</span><span data-if="dotnet" style="display:none">"ww"</span><span data-if="python" style="display:none">"ww"</span>, <span data-if="hdevelop" style="display:inline">'wr'</span><span data-if="c" style="display:none">"wr"</span><span data-if="cpp" style="display:none">"wr"</span><span data-if="com" style="display:none">"wr"</span><span data-if="dotnet" style="display:none">"wr"</span><span data-if="python" style="display:none">"wr"</span>, <span data-if="hdevelop" style="display:inline">'wu'</span><span data-if="c" style="display:none">"wu"</span><span data-if="cpp" style="display:none">"wu"</span><span data-if="com" style="display:none">"wu"</span><span data-if="dotnet" style="display:none">"wu"</span><span data-if="python" style="display:none">"wu"</span>, <span data-if="hdevelop" style="display:inline">'wo'</span><span data-if="c" style="display:none">"wo"</span><span data-if="cpp" style="display:none">"wo"</span><span data-if="com" style="display:none">"wo"</span><span data-if="dotnet" style="display:none">"wo"</span><span data-if="python" style="display:none">"wo"</span>, <span data-if="hdevelop" style="display:inline">'rl'</span><span data-if="c" style="display:none">"rl"</span><span data-if="cpp" style="display:none">"rl"</span><span data-if="com" style="display:none">"rl"</span><span data-if="dotnet" style="display:none">"rl"</span><span data-if="python" style="display:none">"rl"</span>, <span data-if="hdevelop" style="display:inline">'re'</span><span data-if="c" style="display:none">"re"</span><span data-if="cpp" style="display:none">"re"</span><span data-if="com" style="display:none">"re"</span><span data-if="dotnet" style="display:none">"re"</span><span data-if="python" style="display:none">"re"</span>, <span data-if="hdevelop" style="display:inline">'rs'</span><span data-if="c" style="display:none">"rs"</span><span data-if="cpp" style="display:none">"rs"</span><span data-if="com" style="display:none">"rs"</span><span data-if="dotnet" style="display:none">"rs"</span><span data-if="python" style="display:none">"rs"</span>, <span data-if="hdevelop" style="display:inline">'rw'</span><span data-if="c" style="display:none">"rw"</span><span data-if="cpp" style="display:none">"rw"</span><span data-if="com" style="display:none">"rw"</span><span data-if="dotnet" style="display:none">"rw"</span><span data-if="python" style="display:none">"rw"</span>, <span data-if="hdevelop" style="display:inline">'rr'</span><span data-if="c" style="display:none">"rr"</span><span data-if="cpp" style="display:none">"rr"</span><span data-if="com" style="display:none">"rr"</span><span data-if="dotnet" style="display:none">"rr"</span><span data-if="python" style="display:none">"rr"</span>, <span data-if="hdevelop" style="display:inline">'ru'</span><span data-if="c" style="display:none">"ru"</span><span data-if="cpp" style="display:none">"ru"</span><span data-if="com" style="display:none">"ru"</span><span data-if="dotnet" style="display:none">"ru"</span><span data-if="python" style="display:none">"ru"</span>, <span data-if="hdevelop" style="display:inline">'ro'</span><span data-if="c" style="display:none">"ro"</span><span data-if="cpp" style="display:none">"ro"</span><span data-if="com" style="display:none">"ro"</span><span data-if="dotnet" style="display:none">"ro"</span><span data-if="python" style="display:none">"ro"</span>, <span data-if="hdevelop" style="display:inline">'ul'</span><span data-if="c" style="display:none">"ul"</span><span data-if="cpp" style="display:none">"ul"</span><span data-if="com" style="display:none">"ul"</span><span data-if="dotnet" style="display:none">"ul"</span><span data-if="python" style="display:none">"ul"</span>, <span data-if="hdevelop" style="display:inline">'ue'</span><span data-if="c" style="display:none">"ue"</span><span data-if="cpp" style="display:none">"ue"</span><span data-if="com" style="display:none">"ue"</span><span data-if="dotnet" style="display:none">"ue"</span><span data-if="python" style="display:none">"ue"</span>, <span data-if="hdevelop" style="display:inline">'us'</span><span data-if="c" style="display:none">"us"</span><span data-if="cpp" style="display:none">"us"</span><span data-if="com" style="display:none">"us"</span><span data-if="dotnet" style="display:none">"us"</span><span data-if="python" style="display:none">"us"</span>, <span data-if="hdevelop" style="display:inline">'uw'</span><span data-if="c" style="display:none">"uw"</span><span data-if="cpp" style="display:none">"uw"</span><span data-if="com" style="display:none">"uw"</span><span data-if="dotnet" style="display:none">"uw"</span><span data-if="python" style="display:none">"uw"</span>, <span data-if="hdevelop" style="display:inline">'ur'</span><span data-if="c" style="display:none">"ur"</span><span data-if="cpp" style="display:none">"ur"</span><span data-if="com" style="display:none">"ur"</span><span data-if="dotnet" style="display:none">"ur"</span><span data-if="python" style="display:none">"ur"</span>, <span data-if="hdevelop" style="display:inline">'uu'</span><span data-if="c" style="display:none">"uu"</span><span data-if="cpp" style="display:none">"uu"</span><span data-if="com" style="display:none">"uu"</span><span data-if="dotnet" style="display:none">"uu"</span><span data-if="python" style="display:none">"uu"</span>, <span data-if="hdevelop" style="display:inline">'uo'</span><span data-if="c" style="display:none">"uo"</span><span data-if="cpp" style="display:none">"uo"</span><span data-if="com" style="display:none">"uo"</span><span data-if="dotnet" style="display:none">"uo"</span><span data-if="python" style="display:none">"uo"</span>, <span data-if="hdevelop" style="display:inline">'ol'</span><span data-if="c" style="display:none">"ol"</span><span data-if="cpp" style="display:none">"ol"</span><span data-if="com" style="display:none">"ol"</span><span data-if="dotnet" style="display:none">"ol"</span><span data-if="python" style="display:none">"ol"</span>, <span data-if="hdevelop" style="display:inline">'oe'</span><span data-if="c" style="display:none">"oe"</span><span data-if="cpp" style="display:none">"oe"</span><span data-if="com" style="display:none">"oe"</span><span data-if="dotnet" style="display:none">"oe"</span><span data-if="python" style="display:none">"oe"</span>, <span data-if="hdevelop" style="display:inline">'os'</span><span data-if="c" style="display:none">"os"</span><span data-if="cpp" style="display:none">"os"</span><span data-if="com" style="display:none">"os"</span><span data-if="dotnet" style="display:none">"os"</span><span data-if="python" style="display:none">"os"</span>, <span data-if="hdevelop" style="display:inline">'ow'</span><span data-if="c" style="display:none">"ow"</span><span data-if="cpp" style="display:none">"ow"</span><span data-if="com" style="display:none">"ow"</span><span data-if="dotnet" style="display:none">"ow"</span><span data-if="python" style="display:none">"ow"</span>, <span data-if="hdevelop" style="display:inline">'or'</span><span data-if="c" style="display:none">"or"</span><span data-if="cpp" style="display:none">"or"</span><span data-if="com" style="display:none">"or"</span><span data-if="dotnet" style="display:none">"or"</span><span data-if="python" style="display:none">"or"</span>, <span data-if="hdevelop" style="display:inline">'ou'</span><span data-if="c" style="display:none">"ou"</span><span data-if="cpp" style="display:none">"ou"</span><span data-if="com" style="display:none">"ou"</span><span data-if="dotnet" style="display:none">"ou"</span><span data-if="python" style="display:none">"ou"</span>, <span data-if="hdevelop" style="display:inline">'oo'</span><span data-if="c" style="display:none">"oo"</span><span data-if="cpp" style="display:none">"oo"</span><span data-if="com" style="display:none">"oo"</span><span data-if="dotnet" style="display:none">"oo"</span><span data-if="python" style="display:none">"oo"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Shift" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Shift</span><span data-if="c" style="display:none">Shift</span><span data-if="cpp" style="display:none">Shift</span><span data-if="com" style="display:none">Shift</span><span data-if="dotnet" style="display:none">shift</span><span data-if="python" style="display:none">shift</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Shift to reduce the gray value dynamics.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>2</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3, 4, 5, 6, 7, 8, 9</p>
</div>
  <div class="par">
<div class="parhead">
<span id="FilterSize" class="parname"><b><code><span data-if="hdevelop" style="display:inline">FilterSize</span><span data-if="c" style="display:none">FilterSize</span><span data-if="cpp" style="display:none">FilterSize</span><span data-if="com" style="display:none">FilterSize</span><span data-if="dotnet" style="display:none">filterSize</span><span data-if="python" style="display:none">filter_size</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Size of the filter kernel.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>5</p>
<p class="pardesc"><span class="parcat">List of values:
      </span>3, 5, 7</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
* Simple two-dimensional pixel classification
dev_get_window (WindowHandle)
read_image(Image,'combine')
texture_laws(Image,Texture1,'es',3,7)
texture_laws(Image,Texture2,'le',7,7)
MaskSize := 51
mean_image(Texture1,H1,MaskSize,MaskSize)
mean_image(Texture2,H2,MaskSize,MaskSize)
dev_clear_window ()
dev_display (Image)
dev_set_color ('green')
write_string (WindowHandle, 'Mark region within one texture area')
draw_region(Region,WindowHandle)
reduce_domain(H1,Region,Foreground1)
reduce_domain(H2,Region,Foreground2)
histo_2dim(Region,Foreground1,Foreground2,Histo)
get_image_size (Image, Width, Height)
threshold(Histo,Characteristic_area,1,Width*Height)
ShowIntermediateResult := 0
if (ShowIntermediateResult)
  histo_2dim(H1,H1,H2,HistoFull)
  dev_clear_window ()
  dev_set_lut ('sqrt')
  dev_display (HistoFull)
  dev_set_draw ('margin')
  dev_display (Characteristic_area)
  stop ()
  dev_set_lut ('default')
  dev_set_draw ('fill')
endif
class_2dim_sup(H1,H2,Characteristic_area,Seg)
dev_display (Image)
dev_set_color ('red')
dev_display (Seg)
</pre>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">texture_laws</span><span data-if="c" style="display:none">texture_laws</span><span data-if="cpp" style="display:none">TextureLaws</span><span data-if="com" style="display:none">TextureLaws</span><span data-if="dotnet" style="display:none">TextureLaws</span><span data-if="python" style="display:none">texture_laws</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters are correct.  If
the input is empty the behavior can be set via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('no_object_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>.  If necessary, an
exception is raised.</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="mean_image.html"><span data-if="hdevelop" style="display:inline">mean_image</span><span data-if="c" style="display:none">mean_image</span><span data-if="cpp" style="display:none">MeanImage</span><span data-if="com" style="display:none">MeanImage</span><span data-if="dotnet" style="display:none">MeanImage</span><span data-if="python" style="display:none">mean_image</span></a></code>, 
<code><a href="binomial_filter.html"><span data-if="hdevelop" style="display:inline">binomial_filter</span><span data-if="c" style="display:none">binomial_filter</span><span data-if="cpp" style="display:none">BinomialFilter</span><span data-if="com" style="display:none">BinomialFilter</span><span data-if="dotnet" style="display:none">BinomialFilter</span><span data-if="python" style="display:none">binomial_filter</span></a></code>, 
<code><a href="gauss_filter.html"><span data-if="hdevelop" style="display:inline">gauss_filter</span><span data-if="c" style="display:none">gauss_filter</span><span data-if="cpp" style="display:none">GaussFilter</span><span data-if="com" style="display:none">GaussFilter</span><span data-if="dotnet" style="display:none">GaussFilter</span><span data-if="python" style="display:none">gauss_filter</span></a></code>, 
<code><a href="median_image.html"><span data-if="hdevelop" style="display:inline">median_image</span><span data-if="c" style="display:none">median_image</span><span data-if="cpp" style="display:none">MedianImage</span><span data-if="com" style="display:none">MedianImage</span><span data-if="dotnet" style="display:none">MedianImage</span><span data-if="python" style="display:none">median_image</span></a></code>, 
<code><a href="histo_2dim.html"><span data-if="hdevelop" style="display:inline">histo_2dim</span><span data-if="c" style="display:none">histo_2dim</span><span data-if="cpp" style="display:none">Histo2dim</span><span data-if="com" style="display:none">Histo2dim</span><span data-if="dotnet" style="display:none">Histo2dim</span><span data-if="python" style="display:none">histo_2dim</span></a></code>, 
<code><a href="learn_ndim_norm.html"><span data-if="hdevelop" style="display:inline">learn_ndim_norm</span><span data-if="c" style="display:none">learn_ndim_norm</span><span data-if="cpp" style="display:none">LearnNdimNorm</span><span data-if="com" style="display:none">LearnNdimNorm</span><span data-if="dotnet" style="display:none">LearnNdimNorm</span><span data-if="python" style="display:none">learn_ndim_norm</span></a></code>, 
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="convol_image.html"><span data-if="hdevelop" style="display:inline">convol_image</span><span data-if="c" style="display:none">convol_image</span><span data-if="cpp" style="display:none">ConvolImage</span><span data-if="com" style="display:none">ConvolImage</span><span data-if="dotnet" style="display:none">ConvolImage</span><span data-if="python" style="display:none">convol_image</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="class_2dim_sup.html"><span data-if="hdevelop" style="display:inline">class_2dim_sup</span><span data-if="c" style="display:none">class_2dim_sup</span><span data-if="cpp" style="display:none">Class2dimSup</span><span data-if="com" style="display:none">Class2dimSup</span><span data-if="dotnet" style="display:none">Class2dimSup</span><span data-if="python" style="display:none">class_2dim_sup</span></a></code>, 
<code><a href="class_ndim_norm.html"><span data-if="hdevelop" style="display:inline">class_ndim_norm</span><span data-if="c" style="display:none">class_ndim_norm</span><span data-if="cpp" style="display:none">ClassNdimNorm</span><span data-if="com" style="display:none">ClassNdimNorm</span><span data-if="dotnet" style="display:none">ClassNdimNorm</span><span data-if="python" style="display:none">class_ndim_norm</span></a></code>
</p>
<h2 id="sec_references">References</h2>
<p>

Laws, Kenneth Ivan. “Textured Image Segmentation”;  Ph.D. Thesis,
Department of Electrical Engineering, Image Processing Institute,
University of Southern California, 1980
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
